home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 1997 November & December / Amiga-CD 1997 #11-12.iso / pd-disketten / ungepackt / 12_95 / apd-12-95-4-2 / printmanager_2.0 / printmanager.doc < prev    next >
Text File  |  1996-01-25  |  12KB  |  311 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.                               PrintManager 2.0
  4.  
  5. ----------------------------------------------------------------------------
  6.  
  7.  
  8. The files in this archive were written by Nicola Salmoria and are freely
  9. distributable as long as the archive remains intact, and only a nominal fee
  10. is charged for its distribution.
  11.  
  12. This software is provided "AS IS" without warranty of any kind, either
  13. expressed or implied. By using it, you agree to accept the entire risk as to
  14. the quality and performance of the program.
  15.  
  16. This program is SHAREWARE. If you use it, send $20 (or Lit. 25.000) to the
  17. author. If possible, send cash, no cheques: otherwise I lose half of the
  18. money cashing them.
  19. Please note that the software in this archive is not 'crippled' in any way:
  20. I'm not trying to force you to send money by removing important features.
  21. Don't make me regret this choice.
  22.  
  23. Comments, suggestions and bug reports are welcome.
  24.  
  25.    Nicola Salmoria
  26.    Via Piemonte 11
  27.    53100 Siena   ITALY
  28.  
  29.  
  30.    E-Mail: MC6489@mclink.it
  31.  
  32.  
  33.  
  34. Overview
  35. --------
  36. One of the things Workbench 2.0 (and 3.0) is still missing is a printer
  37. spooler.
  38. PrintManager is just that. There are some other programs that try to
  39. implement a spooler on the Amiga, but:
  40. · PrintManager is a system wedge, so it will work with every program, not
  41.   just ones explicitly written to take advantage of it;
  42. · The wedge is installed at parallel or serial device level, so PrintManager
  43.   will really work with EVERY program: no matter if it uses PRT: or directly
  44.   the printer device, no matter if it's printing text or graphics. Even
  45.   programs that use directly PAR: or SER: can be cached using the DEVICE
  46.   ToolType.
  47. · Only printer device calls are cached, so modem and net users will not
  48.   experiment performance loss.
  49. · PrintManager has a nice, font sensitive graphic user interface (GUI) and
  50.   supports localization under Workbench 2.1 or later.
  51. · You can print files directly from PrintManager, using either the AppIcon,
  52.   or the AppWindow, or a menu command.
  53.   Under Kickstart 2.x only text files may be printed; under Kickstart 3.x
  54.   datatypes.library is used so you can print anything which is recognized by
  55.   MultiView.
  56. · The printer-specific raw data can be saved to a file. That file may be
  57.   printed at a later time via PrintManager itself, or brought to another
  58.   computer (since it contains raw data, you just have to send it unchanged
  59.   to the printer). For example, you may prepare an article at home and use
  60.   the expensive laser printer at office to print it.
  61. · After a system crash or reset, unfinished printings are automatically
  62.   recovered. This feature may also be used to prepare raw data and print it
  63.   at a later time.
  64. · A Form Feed may be automatically inserted between printings.
  65.  
  66.  
  67.  
  68. Requirements
  69. ------------
  70. · OS 2.04 or later
  71. · Hard disk is not required but strongly recommended
  72. · Printer ;-)
  73.  
  74.  
  75.  
  76. Installation
  77. ------------
  78. Copy spool.device in DEVS:.
  79. The spooler is actually activated by running PrintManager. Some parameters
  80. may be changed via icon ToolTypes. Recognized ToolTypes are:
  81.  
  82. CX_POPUP                 default: YES
  83.   This one tells if the program window should be opened when it is run for
  84.   the first time. If you drag PrintManager's icon in the WBStartup drawer
  85.   to activate it automatically, you should set this ToolType to NO.
  86.  
  87. CX_POPKEY                default: control alt p
  88.   This is the "hot key", the input sequence which opens the window if it is
  89.   closed, or brings it to the front if it is already open. Refer to the
  90.   Amiga User Manual for a complete specification of the recognized keywords.
  91.  
  92. CX_PRIORITY              default: 0
  93.   The priority of the commodity handler used for the hot key. You will not
  94.   need to change this.
  95.  
  96. SPOOLDRAWER              default: T:spool
  97.   The directory where temporary files should be stored. You should change it
  98.   to somewhere in your hard disk, since on a standard machine T: is assigned
  99.   to RAM:T. Temporary files may be quite large (some megabytes if you are
  100.   printing graphic in high density), and you could run out of memory very
  101.   quickly otherwise.
  102.   If the directory specified doesn't exist, it will be created.
  103.  
  104. PRINTDRAWER
  105.   The name of the directory where the "Print..." file requester should be
  106.   positioned the first time it is invoked.
  107.  
  108. SAVEDRAWER
  109.   The name of the directory where the "Save As..." file requester should be
  110.   positioned the first time it is invoked.
  111.  
  112. PAUSED                   default: NO
  113.   This specifies the initial state of « Next Job ». See later for details.
  114.  
  115. APPICON                  default: ACTIVE
  116.   PrintManager can put an icon on the Workbench screen. Double clicking it
  117.   will act like pressing the "hot key"; dragging files on it will cause
  118.   them to be added to the print queue.
  119.  
  120.   There are three valid keywords for this ToolType:
  121.   ALWAYS - Show the icon when the program is started, remove it when
  122.     quitting.
  123.   NEVER - Never show the icon.
  124.   ACTIVE - Show the icon only if the print queue is not empty and the window
  125.     is not open. This feature will help to remember if there are recovered
  126.     jobs after a reset.
  127.  
  128. ICONX
  129. ICONY
  130.   These two specify the position on the Workbench screen where to put the
  131.   icon. If you don't specify _both_ of them, Workbench will place it by
  132.   itself.
  133.  
  134. PUBSCREEN
  135.   The name of the public screen where to open the window. May be very useful
  136.   if used together with the program "FrontPublicScreen" included in this
  137.   archive.
  138.  
  139. DEVICE
  140. UNIT
  141.   By default, PrintManager will automatically detect if the printer
  142.   configured in Preferences is parallel or serial, and will intercept calls
  143.   to the appropriate device only if they are made by printer.device.
  144.   This means that PrintManager will not interfere with, for example, a
  145.   scanner connected via a switch to the same port of the printer.
  146.   Unfortunately, it also means that only programs using printer.device or
  147.   PRT: will benefit from the spooler; programs using parallel.device or PAR:
  148.   will not.
  149.  
  150.   Providing a device name (and an optional unit number) will cause ALL and
  151.   ONLY the calls to that device to be cached. For example, for a parallel
  152.   printer use:
  153.      DEVICE=parallel.device
  154.  
  155. CREATEICONS
  156.   Specifies if files created with the "Jobs/Save As..." command should have
  157.   an icon or not. This is the same as the menu Settings/Create Icons?
  158.  
  159. AUTOFORMFEED
  160.   If this is set to YES, a Form Feed will be automatically sent to printer
  161.   after each job. This is the same as the menu Settings/Auto Form Feed?
  162.  
  163.  
  164.  
  165. Using the GUI
  166. -------------
  167. GUI usage should be fairly intuitive; clicking on a job makes it the
  168. "current" one, and allows you to perform some operations on it.
  169. You may pause/restart the job using the Active/Paused cycle button, or
  170. remove it from the list with the Remove button. You can sort the list using
  171. the Up and Down buttons. A job being printed cannot be moved from the top of
  172. the list. Jobs brought to the top of the list are automatically paused to
  173. prevent accidental activation.
  174.  
  175. Above the print queue are displayed the name of the job currently printed
  176. and a progress bar showing the percentage of data sent to the printer.
  177. Note: the progress bar doesn't appear until the program which is printing
  178. completes its work.
  179.  
  180. There is a special entry in the list, named "« Next Job »". It represents
  181. the position where the next job you start will be placed. The new job will
  182. also inherit the setting of the Active/Paused button. This means that if you
  183. set « Next Job » to Paused, nothing will be printed until you explicitly
  184. start it. The initial setting of the Active/Paused button may be changed
  185. using the PAUSED ToolType.
  186.  
  187. When started, PrintManager will look in the SPOOLDRAWER you specified and see
  188. if there are jobs left from previous sessions. If it finds some, they will be
  189. automatically inserted AFTER « Next Job ». This way, you can continue to use
  190. the printer without taking care of old jobs; when you want to restart one of
  191. them, you just have to open the GUI, bring the job to the top of the list,
  192. and unpause it. To restart them all, bring « Next Job » to the bottom of the
  193. list and unpause the first job.
  194.  
  195.  
  196.  
  197. Printing from inside PrintManager
  198. ---------------------------------
  199. Files may be printed directly from inside PrintManager. This can be done in
  200. three ways:
  201. · Dragging icons on the AppIcon (that is the icon in the Workbench window,
  202.   NOT the program icon). The status of the AppIcon may be changed using the
  203.   APPICON ToolType.
  204. · Dragging icons on PrintManager's window.
  205. · Using the Project/Print... menu item.
  206.  
  207. Under Kickstart 2.0, only text files may be printed. Under Kickstart 3.0,
  208. datatypes.library is used, so you can print anything that is recognized by
  209. MultiView.
  210. Moreover, raw data saved with Jobs/Save As... may be recovered. This feature
  211. may be useful, for example, to print multiple copies of a document.
  212. NOTE: Raw data files are recognized by their comment, which must be
  213. "Raw Printer Data". When you save them using Save As... the comment is set
  214. automatically. Make sure not to modify it.
  215.  
  216.  
  217.  
  218. Menus
  219. -----
  220. Project/About
  221.   Self explanatory.
  222.  
  223. Project/Print...
  224.   Brings up a file requester allowing you to select one or more files to
  225.   print. This is the same as dragging icons over the AppIcon or the
  226.   AppWindow.
  227.   The initial drawer displayed by the file requester may be changed with the
  228.   PRINTDRAWER ToolType.
  229.  
  230. Project/Hide
  231.   Closes the window, but leaves PrintManager resident in memory.
  232.  
  233. Project/Quit
  234.   Terminates PrintManager. You cannot quit if the print queue is not empty.
  235.  
  236. Jobs/Save As...
  237.   This allows you to save a job as printer specific raw data. The file
  238.   created may be sent directly to the printer, either via PrintManager, or
  239.   a device like PAR:, or even on a different computer.
  240.   This operation cannot be performed on jobs which have "n/a" in the Size
  241.   column.
  242.   Since the copy of the file happens asynchronously, it is a good idea to
  243.   pause printing before saving. Otherwise, the operation will take much
  244.   longer, due to contemporary accesses to the hard disk by two different
  245.   tasks (the one which copies the file, and the one which prints).
  246.   IMPORTANT NOTE: the saved files have a "Raw Printer Data" comment
  247.   associated. That is the only way PrintManager has to recognize such files
  248.   from the other files you try to print. If you remove or modify the
  249.   comment, the file will not be printed correctly.
  250.   The initial drawer displayed by the file requester may be changed with the
  251.   SAVEDRAWER ToolType.
  252.  
  253. Jobs/Remove All
  254.   Removes all the jobs from the print queue.
  255.  
  256. Options/Create Icons?
  257.   Specifies if files created with the "Jobs/Save As..." command should have
  258.   an icon or not.
  259.   The initial setting of this item may be changed using the CREATEICONS
  260.   ToolType.
  261.  
  262. Options/Auto Form Feed?
  263.   If this item is checked, a Form Feed will be automatically sent to printer
  264.   after each job.
  265.   The initial setting of this item may be changed using the AUTOFORMFEED
  266.   ToolType.
  267.  
  268.  
  269.  
  270. Limitations
  271. -----------
  272. Currently, only one device at a time may be spooled. You cannot work around
  273. this limitation running multiple copies of PrintManager, because there can
  274. be only one copy running at a time.
  275. However, if you are not using the DEVICE ToolType, the spooler will
  276. automatically switch from parallel to serial if you change the Preferences
  277. settings. The print queue must be empty for the change to take effect.
  278. Removing this limitation is not a trivial task; an additional difficulty is
  279. that I don't have two printers to test it. Since most users are in the same
  280. situation, I've decided to leave it as it is, for now. Whether I improve it
  281. or not will depend on many factors, not last how many shareware
  282. contributions I'll receive.
  283.  
  284.  
  285.  
  286. Acknowledgments
  287. ---------------
  288. As usual, I have to thank my beta testers, whose help has been invaluable
  289. during the development of this program:
  290.  
  291. Stefano Iacus
  292. Federico Giannici
  293. Dante Profeta
  294. Marco Ciuchini
  295. Massimiliano Filacchioni
  296. Marcello Bianchetti
  297. Stefano Chiappini
  298.  
  299. Special thanks go to all the people which E-Mailed me useful suggestions and
  300. bug reports. In particular:
  301.  
  302. Matt Brookes
  303. Jeremy Friesner
  304. Bill Hogsett
  305. Kay Bolay
  306. Andreas Jantos for the german catalog
  307. J.P. Hillenburg
  308. Graham Walter
  309.  
  310. Thank you very much!
  311.